home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / biz / demo / origins.lzh / Tutorial.doc < prev   
Text File  |  1993-04-25  |  14KB  |  346 lines

  1. File: Tutorial.doc - Origins Demo entry level tutorial
  2. Last Update: 26 Apr 1993
  3.  
  4.  
  5.                       *******************************
  6.                       *     Origins_Demo V1.07      *
  7.                       * ©1993 by The Puzzle Factory *
  8.                       *     All Rights Reserved     *
  9.                       *******************************
  10.  
  11.  
  12. A Short Tutorial for the Origins Demo
  13. =====================================
  14. This file contains a short lesson to give you a feel for working with
  15. Origins.  The exercise is organized into a sequence of steps to follow during
  16. a single session.  These steps will describe what functions to invoke, as
  17. well as what you will see on the screen.  To take full advantage of the
  18. tutorial and learn about Origins' features, you should execute each step
  19. completely.
  20.  
  21. All steps that you should perform will be indicated by an asterisk at the
  22. beginning of the line.
  23.  
  24. Start Origins
  25. Start the Origins program.
  26.  
  27. When Origins is run, it will open the GenFile, Person file, Ordinance file,
  28. and Marriage file.  The GenFile is the configuration file.  The Person file
  29. is a collection of records, each describing a Person, with links to other
  30. records, describing other people related to that Person.  The Ordinance file
  31. is a collection of records linked to the Person file.  Each record in the
  32. Ordinance file describes extra details of the person such as baptism,
  33. confirmation, immigration dates, occupation, etc.  The Marriage file is also
  34. a collection of records linked to the person file.  Each record in the
  35. Marriage file describes details of a wedding such as date, location, etc.
  36.  
  37. The Person file and the Ordinance file provided with the Origins Demo contain
  38. 100 initial records, all blank, for your immediate use.  The Marriage file
  39. contains 50 blank records.  Each record may contain information about 1
  40. person, 1 baptism, etc., or 1 marriage.  In the demo version of Origins,
  41. these files are of fixed length, and may not be expanded.
  42.  
  43. To avoid cluttering up this section with <Your Name Goes Here>, we'll  use  a
  44. fictitious  family made up of  6  individuals  for  our  examples.  They are
  45. listed below.  Feel free to enter your own family instead as you  go  through
  46. the tutorial with us.
  47.  
  48. The Son:         Robert Smith
  49. Birth date:      07 Jan 1947
  50. Birth place:     Orange, Orange, CA, USA
  51.  
  52. The Daughter:    Julia Smith
  53. Birth date:      02 Nov 1951
  54. Birth place:     Anaheim, Orange, CA, USA
  55.  
  56. The Father:      Harold Burnett Smith
  57. Birth date:      15 May 1916
  58.  
  59. The Mother:      Sarah Jean Mayfield
  60. Birth date:      03 Jun 1915
  61. Birth place:     VA, USA
  62.  
  63. Married:         15 Jun 1938, Norfolk, VA
  64.  
  65. The Grandfather: Harold Edward Smythe
  66. Birth date:      23 Aug 1881
  67. Birth place:     Blackburn, Lancashire, no state, England
  68. Death date:      c.1943
  69.  
  70. The Grandmother: Margaret Reade Elston
  71. Birth date:      c.1884
  72.  
  73. Married:         26 Sep 1902
  74.  
  75. The first thing you will want to do is enter information into the data base.
  76. After each entry, remember to press RETURN.  This tells Origins that you
  77. entered some data, and moves the cursor to the next field.
  78.  
  79. * Select "UPDATE/Persons File:" from the menu.  You'll see the Update Person
  80.   Requester.
  81.  
  82. Simply hit RETURN to enter the '0' you see in the string gadget, and you'll
  83. see a Person entry screen.  We'll begin by entering the son.
  84.  
  85. Make sure the cursor is in the Surname field.  If it's not, use the ENTER key
  86. or a mouse click to put the entry cursor on the Surname field.  Finding the
  87. invisible string gadgets may be unfamiliar at first, but will become easier
  88. if you remember that there is descriptive text before each one, and all the
  89. gadgets are left justified in a column.  After you become used to them, we
  90. hope you'll appreciate the clean, uncluttered display.
  91.  
  92. * Enter "SMITH" in the Surname field.  Remember to press RETURN.
  93.  
  94. Upper case is used by genealogists to emphasize the surname; you may choose
  95. to do this or not.  It's not enforced by Origins.
  96.  
  97. * Enter "Robert" in Given Names field.
  98.  
  99. * Enter "m" in the Gender field.  Case doesn't matter.
  100.  
  101. * Press RETURN in the Code field.  You can make up your own codes later.
  102.  
  103. * Move the cursor to the Person's Birth date field.  Enter "07 Jan 1947".
  104.  
  105. * Enter "Orange" in the Person's Birth City field.
  106.  
  107. * Enter "Orange" in the Person's Birth County field.
  108.  
  109. * Enter "CA" in the Person's Birth State field.
  110.  
  111. * Enter "USA" in the Person's Birth Country field.
  112.  
  113. * We are finished entering this Person.  Click on the SAVE gadget.
  114.  
  115. After the disk activity is over, you will get a requester that says:
  116.  
  117.        "Person record has been saved.  Update Ordinance record now?"
  118.  
  119. * This requester appeared because a User Preferences switch named AutoOrd
  120.   (Automatic Ordinance) defaults to ON when the program is used for the first
  121.   time.  We don't have any Ordinance information for this Person, so just
  122.   click on Cancel.
  123.  
  124. * We will now enter the daughter.  Click on the NEXT gadget.  You'll get a
  125.   requester that says:
  126.  
  127.        "Record does not exist.  Want 1st blank record?"
  128.  
  129. * Since we have only entered one record, there is no record #2.  Click on OK
  130.   to get the 1st blank record.  Make sure the cursor is in the Surname field.
  131.  
  132. * Enter "SMITH" in the Surname field.
  133.  
  134. * Enter "Julia" in Given Names field.
  135.  
  136. * Enter "f" in the Gender field.
  137.  
  138. * Press RETURN in the Code field.
  139.  
  140. You'll see "-3" in the Father's Record # field.  The negative number
  141. indicates that this is a blank record; the value indicates that this is
  142. record #3.
  143.  
  144. * Press RETURN in the Father's Record # field.  Don't worry that the number
  145.   stays negative.
  146.  
  147. * Enter "SMITH" in the Father's Surname field.
  148.  
  149. * Enter "Harold Burnett" in the Father's Given Names field.
  150.  
  151. * Enter "15 May 1916" in the Father's Birth date field.
  152.  
  153. You'll see "-4" in the Mother's Record # field.  This indicates that this is
  154. record #4 and it is blank.
  155.  
  156. * Press RETURN in the Mother's Record # field.  Don't worry that the number
  157.   stays negative.
  158.  
  159. * Enter "MAYFIELD" in the Mother's Surname field.
  160.  
  161. * Enter "Sarah Jean" in  the  Mother's  Given Names field.
  162.  
  163. * Enter "03 Jun 1915" in the Mother's Birth date field.  Notice that the
  164.   cursor moves to upper right part of screen when you press RETURN.
  165.  
  166. * Enter "02 Nov 1951" in the Person's Birth date field.
  167.  
  168. * Enter "Anaheim" in the Person's Birth City field.
  169.  
  170. * Enter "Orange" in the Person's Birth County field.
  171.  
  172. * Enter "CA" in the Person's Birth State field.
  173.  
  174. * Enter "USA" in the Person's Birth Country field.
  175.  
  176. * We have finished entering this Person.  Click on the SAVE gadget, and
  177.   cancel the Ordinance requester.
  178.  
  179. Do not make a note of the mother's and father's record numbers at this time.
  180. Although in this case the record numbers remain valid, they don't in all
  181. circumstances.
  182.  
  183. Now we are going to enter more information on the father and mother.  We
  184. could get there by using the SPECIFY gadget, but in this case, since we were
  185. already at the first blank record number, it's even easier to click on the
  186. NEXT gadget, and continue dealing with records in order.
  187.  
  188. * Click on the NEXT gadget.  You'll see the Father's entry screen, with name,
  189.   gender, and birth date already filled in.  Origins automatically created
  190.   this record for you when you saved Julia's record.
  191.  
  192. * Use the ENTER key or a mouse click to put the entry cursor in the Person's
  193.   Father's Surname field (not the Person's Surname field).  Here we are
  194.   entering the father's father, or grandfather, and father's mother, or
  195.   grandmother.  Enter the following data in order:
  196.  
  197.   Person's Father's Surname field:     "SMYTHE"
  198.   Person's Father's Given Names field: "Harold Edward"
  199.   Person's Father's Birth date field:  "23 Aug 1881"
  200.  
  201.   Press RETURN to accept the next blank record number.
  202.   Person's Mother's Surname field:     "ELSTON"
  203.   Person's Mother's Given Names field: "Margaret Reade"
  204.   Person's Mother's Birth date field:  "c.1884"
  205.  
  206. * As before, click on the SAVE gadget, cancel the Ordinance requester, then
  207.   click on the NEXT gadget.  Now you'll see Sarah MAYFIELD's entry screen.
  208.   Use the mouse pointer to click on the Birth state field, and enter the
  209.   following data in order:
  210.  
  211.   Person's Birth state:       "VA"
  212.   Person's Birth country:     "USA"
  213.  
  214. * Once again, click on the SAVE gadget, cancel the Ordinance requester, then
  215.   click on the NEXT gadget.  Now you'll see the entry screen of Harold Edward
  216.   SMYTHE, the grandfather.  Click on the Birth city field, and enter the
  217.   following data in order:
  218.  
  219.   Person's Birth city:        "Blackburn"
  220.   Person's Birth county:      "Lancashire"
  221.   Person's Birth state:       Press RETURN (no state)
  222.   Person's Birth country:     "England"
  223.   Person's Death date:        "c.1943"
  224.  
  225. * Click on the SAVE gadget, but this time, at the Ordinance requester, click
  226.   on OK.  Now you'll see an Ordinance data entry screen.
  227.  
  228. * Position the cursor by clicking on the Immigration Details: Arrival field,
  229.   and enter the following data in order:
  230.  
  231.   Arrival:    "Ellis Island, New York"
  232.   Date:       "12 Mar 1901"
  233.   Occupation: "carpenter"
  234.  
  235. * Click on the SAVE gadget.  Notice that we were returned to the Update
  236.   Person screen.
  237.  
  238. We have now described all the Persons in the Smith family, but we have one
  239. more thing to do before going on; we need to describe the relationship
  240. between Robert Smith (the first record we entered), and his parents.
  241.  
  242. * Click on the SPECIFY gadget, and enter "1" in the requester.  You'll see
  243.   Robert Smith's Person record.
  244.  
  245. * Place the cursor in the Person's Father's record # field.  Hold down the
  246.   right-Amiga key and press the "X" key to erase this field.  Then enter the
  247.   record number of Robert's father, "3".  You will see the name Harold
  248.   Burnett Smith appear on the lines below.
  249.  
  250. * Place the cursor in the Person's Mother's record # field.  Hold down the
  251.   right-Amiga key and press the "X" key to erase this field.  Then enter the
  252.   record number of Robert's mother, "4".  You will see the name Sarah Jean
  253.   MAYFIELD appear on the lines below.
  254.  
  255. * We are through with this record.  Click on the SAVE gadget and cancel the
  256.   Ordinance requester.
  257.  
  258. Persons are only referenced by number, never by name.  This is because record
  259. numbers are always unique, but Persons may share the same name, birth date,
  260. etc.  Because of this you will want to have the list of Persons that have
  261. been previously entered handy when adding new Persons, Ordinances, Marriages,
  262. etc.  This can be easily done in two ways, depending upon your style.  Either
  263. print the Person (Marriage, Parent/Child) List on paper and refer to it while
  264. entering data, or direct the output of the list functions to a file, and let
  265. multi-tasking work for you, by loading the file in your favorite editor and
  266. flipping screens to access the lists.
  267.  
  268. In this tutorial we will generate a list of persons (the Smith family) by
  269. printing it out on paper.
  270.  
  271. * Click on the QUIT gadget to exit the Update Person screen.  Select "List/
  272.   Person's Records:" from the menu.  You will see a the List Requester.
  273.  
  274. * Click on the PRINTER gadget, and then the OK gadget.  You'll get a
  275.   requester asking if the printer is ready.  When it is, click on OK.
  276.  
  277. Now that you have a list of the 6 Persons in the Smith family, we will enter
  278. two marriages.
  279.  
  280. * Select "UPDATE/Marriage File:" from the menu.  You'll see the Update
  281.   Marriage Requester.
  282.  
  283. Simply hit RETURN to enter the '0' you see in the string gadget, and you'll
  284. see a Marriage entry screen.  We'll begin by entering the parent's marriage.
  285.  
  286. * Place the cursor in the Husband's Record # field.  Press right-Amiga x to
  287.   clear the field.  Enter the record number of Harold Burnett Smith (should
  288.   be #3).  You should now see Harold Smith's name appear on the line below.
  289.  
  290. * Press right-Amiga x to clear the Wife's Record # field, and enter the
  291.   record number of Sarah Jean Mayfield (should be #4).  You should now see
  292.   Sarah Mayfield's name appear on the line below.
  293.  
  294. * Place the cursor in the Marriage date field and enter the following data:
  295.  
  296.   Marriage date field:    "15 Jun 1938"
  297.   Marriage city field:    "Norfolk"
  298.   Marriage state field:   "VA"
  299.   Marriage country field: "USA"
  300.  
  301. * We are finished entering this Marriage.  Click on the SAVE gadget.
  302.  
  303. * We have one more marriage to enter.  Click on the NEXT gadget.  You'll get a
  304.   requester that says:
  305.  
  306.        "Record does not exist.  Want 1st blank record?"
  307.  
  308. * Since we have only entered one marriage record, there is no record #2.
  309.   Click on OK to get the 1st blank record.  Make sure the cursor is in the
  310.   Husband's Record # field.
  311.  
  312. * Press right-Amiga x to clear the field, and enter the record number of
  313.   Harold Edward Smythe (should be #5).  You should now see Harold Smythe's
  314.   name appear on the line below.
  315.  
  316. * Press right-Amiga x to clear the Wife's Record # field.  Enter the record
  317.   number of Margaret Reade Elston (should be #6).  You should now see
  318.   Margaret Elston's name appear on the line below.
  319.  
  320. * Place the cursor in the Marriage date field and enter "26 Sep 1902".
  321.  
  322. * We are finished entering this Marriage.  Click on the SAVE gadget.
  323.  
  324. * Click on the QUIT gadget to exit the Update Marriage screen.
  325.  
  326. Many functions in Origins rely on having Parent/Child and Marriage Indexes
  327. available.  We are now going to create those indexes.
  328.  
  329. * Select "CREATE/Parent/Child Index:" from the menu.
  330.  
  331. * When the disk activity stops, select "CREATE/Marriages Index:"  from the
  332.   menu.
  333.  
  334. This concludes our tutorial.  You may now experiment with various Origins
  335. functions.  We suggest that you might want to try "DISPLAY/Pedigree:" next,
  336. using the son as the root of the pedigree to begin.
  337.  
  338. Please remember that Persons must already be described in order to enter
  339. Ordinance or Marriage information.  The Person data base is the only one
  340. where you may describe the attributes of a person.
  341.  
  342. Always remember to update the appropriate index when generating lists that
  343. require an index.
  344.  
  345. =eof=
  346.